home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / asmutil / d86v322.zip / D04.DOC < prev    next >
Text File  |  1989-08-07  |  12KB  |  258 lines
  1. CHAPTER 4    D86 CONTROL KEYS
  2.  
  3. D86 has a set of functions invoked by single keys.  Keys which
  4. switch the display (for example, to show a help screen) can be
  5. pressed in any context, to be acted upon immediately.  Other
  6. keys, such as the single-stepping keys, can be invoked any time
  7. D86 is awaiting the beginning of an assembly language command.
  8.  
  9.  
  10. Display Control Keys
  11.  
  12. There are numerous keys that let you control the switchable
  13. window in the upper right corner of the screen.  The F10 and
  14. Alt-F10 keys let you toggle between windows, giving you a "tour"
  15. of what's available.  Various keys accessed by using the "Ctrl"
  16. key as a shift key let you move directly to the window of your
  17. choice.
  18.  
  19. The keys in this section are acted upon in any debugger context,
  20. whether you are in the main command mode or in the middle of one
  21. of the other modes (typing in a debugger command, an
  22. immediate-execute line, a patch-memory line, or a memory window
  23. specification):
  24.  
  25. ALT-F10   Toggles you between Help and Non-Help modes.  If the
  26.           window is showing you a help page, it will switch to
  27.           the last Non-Help page that was displayed.  If not, the
  28.           window switches to the last Help screen displayed for
  29.           the current context.
  30.  
  31.           (HELP key on Wang and DEC, F11 key on TI-PC, CTRL-PF5
  32.           key on Sanyo)
  33.  
  34. F10       In non-help mode, toggles you between the available
  35.           non-help windows: the sign-on/second disassembly
  36.           window, the status window, the memory display window,
  37.           and, if you have a floating-point chip, the
  38.           floating-point display window.
  39.  
  40.           In help mode, toggles you between the help windows
  41.           available in the current context.
  42.  
  43.           (Keypad 0 on the DEC, Print Screen on the Z-100)
  44.  
  45. Ctrl-I    (or TAB) takes you from any other window directly to
  46.           the sign-on/second disassembly window.  This window
  47.           contains the D86 sign-on message until the first time
  48.           that the Instruction Pointer leaves the first
  49.           disassembly page.  From that point on, the sign-on
  50.           message is no longer available, and you get a second
  51.           disassembly page instead.
  52.  
  53. Ctrl-S    Takes you from any other window directly to the
  54.           debugger status window.
  55.  
  56. Ctrl-F    Takes you from any other window directly to the
  57.           floating point display window, if your machine has a
  58.           floating point chip in operation.  If not, this key is
  59.           ignored.
  60.                                                               4-2
  61.  
  62. Ctrl-N    If you have a memory display window in sight, this key
  63.           advances to the Next window full of memory.
  64.  
  65.           If you do not have a memory display window, but do have
  66.           at least one memory line specification, this key takes
  67.           you from any other window to the memory display window,
  68.           continuing from the end of the last line display.
  69.  
  70.           If you have no memory line specifications set up, this
  71.           key is ignored.
  72.  
  73. Ctrl-P    If you have a memory display window in sight, this key
  74.           retreats the pointer to memory displayed, by the amount
  75.           displayed in the window.  If all the memory formats
  76.           specified generate a fixed-size display (such as the
  77.           B,W,T formats), then this will effect a "Previous page"
  78.           function.  If there are formats producing a
  79.           variable-size display (such as the N,D,C,S,L formats),
  80.           then the retreat will be a probably imperfect
  81.           approximation to an appropriate "Previous page" amount.
  82.  
  83.           If you do not have a memory display window, this key
  84.           will go to one, just like the Ctrl-N key.
  85.  
  86. Ctrl-Q    If you are not displaying a help window, this key takes
  87.           you to the last help window that was displayed for the
  88.           current context.  If you are already displaying a help
  89.           window, this key toggles through all the help windows
  90.           available for this context.
  91.  
  92.  
  93. Instruction Pointer Positioning Control Keys
  94.  
  95. All the remaining keys in this chapter can be invoked any time
  96. the debugger is in its main command mode, awaiting the first key
  97. of a debugger command or immediate assembly line.  They change
  98. the value of the Instruction Pointer (IP register), and thus they
  99. change the disassembly display.
  100.  
  101. None of the control keys in this section cause any program code
  102. to be executed, other than the equivalent of a JMP instruction,
  103. to the place that the disassembly cursor winds up.
  104.  
  105. WARNING: On some debuggers, you can change the location of what
  106. is being disassembled without changing the IP register value.
  107. I've decided on a "what you see is what you get" philosophy,
  108. since you may well be moving the IP cursor to effect a jump in
  109. the program (for example, you might use the Down-Arrow key to
  110. experimentally skip over the execution of one or more
  111. instructions in the program).  If your intention was just to look
  112. around the program before continuing execution at the place you
  113. left off, you may use the HOME key to return to the place where
  114. execution last halted.
  115.  
  116. Down-Arrow   Jump to the instruction following the current one.
  117.              Visually, the disassembly cursor moves down by one
  118.              instruction line.
  119.                                                               4-3
  120.  
  121. Up-Arrow     Jump to the instruction preceding the current one.
  122.              Visually, the disassembly cursor moves up by one
  123.              instruction line.  NOTE that the implementation of
  124.              this function is a little tricky, since it's
  125.              impossible to reliably disassemble backwards.  What
  126.              D86 does is retreat a fixed, fair-sized distance,
  127.              disassemble forward until the current instruction is
  128.              reached, and take the instruction disassembled just
  129.              before the current one.  If there is non-instruction
  130.              code in memory shortly before the current position,
  131.              the synchronization may fail, and this instruction
  132.              may put you in the middle of a previous instruction
  133.              instead of the beginning.  If this happens, you may
  134.              adjust by using the Ctrl-D or Ctrl-U keys.
  135.  
  136. Ctrl-D       This key is identical to the Down-Arrow key, except
  137.              the jump forward is just one byte, instead of a full
  138.              (usually multibyte) instruction.  (IP is
  139.              incremented.)  You use this key when you think
  140.              you've landed in the middle, rather than the start,
  141.              of an instruction.
  142.  
  143. Ctrl-U       This key decrements IP, moving the cursor "Up" by
  144.              one byte's worth.  Like Ctrl-D, it is used to
  145.              manually synchronize disassembly.
  146.  
  147. Pg Dn        Jump to the next disassembly page, at the memory
  148.              location immediately following this page.  Repeated
  149.              pressing of this key allows you to scan program code
  150.              quickly.
  151.  
  152.              (Alt-Down-Arrow on the TI-PC, Ctrl-C on the Victor,
  153.              Next Screen on the DEC, F12 on the Z-100)
  154.  
  155. Pg Up        Jump to the previous disassembly page, ending with
  156.              the instruction just before the top instruction on
  157.              the current page.  NOTE the warning given with the
  158.              Up-Arrow description, about possible synchronization
  159.              problems, applies here as well.
  160.  
  161.              (Alt-Up-Arrow on the TI-PC, Ctrl-R on the Victor,
  162.              Prev Screen on the DEC, F11 on the Z-100)
  163.  
  164. Home         If you have moved the IP cursor since the last
  165.              program instruction executed, then this key returns
  166.              IP to that spot.  If you are already at that spot,
  167.              this key returns you to the program's starting
  168.              location.  For COM files, this is always location
  169.              0100 in the original code segment.  For EXE files,
  170.              this location was derived from the EXE header
  171.              record.  Note that repeated pressing of HOME will
  172.              cause IP to alternat